home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / MUSIUSIC / MMUSIC.LZH / MMUSIC.DOC < prev    next >
Text File  |  1986-05-03  |  24KB  |  803 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                               Mouse Composition System
  27.  
  28.                                     User's Guide
  29.  
  30.                                      Version 1.0
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.           (C) Copyright by Mike Kirsch, 1986--All rights reserved worldwide
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.           __________________________________________________________________
  60.  
  61.                                                            TABLE OF CONTENTS
  62.           __________________________________________________________________
  63.  
  64.  
  65.           INTRODUCTION                                                     1
  66.  
  67.           GETTING STARTED                                                  3
  68.  
  69.           THE INPUT SCREEN                                                 4
  70.           Music Area                                                       5
  71.           Functions Area                                                   7
  72.  
  73.           USING THE PROGRAM                                                8
  74.  
  75.           REGISTRATION FORM                                               12
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.                                                                 INTRODUCTION
  83.  
  84.           __________________________________________________________________
  85.  
  86.  
  87.           Overview       Welcome to the Mouse Composition System.  The
  88.                          system allows you to compose, play and edit songs
  89.                          by moving a cursor around the screen using a mouse.
  90.  
  91.  
  92.           Reference      If you're not familiar with the music that the IBM
  93.                          PC/XT/AT/JR computer can play, refer to the
  94.                          description of the PLAY command in the IBM BASIC
  95.                          manual.
  96.  
  97.  
  98.           Requirements   To use this system you must have:
  99.  
  100.                            o An IBM PC/XT/AT/JR or compatible computer.
  101.  
  102.                            o A Microsoft, Mouse Systems or compatible mouse.
  103.  
  104.                            o 256K or more memory.
  105.  
  106.  
  107.           Files          The system consists of the following files:
  108.  
  109.                            o COMPOSE.EXE--The composition system's program
  110.                              file.
  111.  
  112.                            o COMPOSE.DOC--This guide, which may be printed
  113.                              using DOS's PRINT or COPY commands.
  114.  
  115.                            o COMPOSE.CFG--A configuration file that
  116.                              describes your computer's monitor and printer
  117.                              to the system.  If you're using a color
  118.                              monitor, you may change the display's
  119.                              foreground, background and border to colors of
  120.                              your liking.
  121.  
  122.  
  123.           Registration   This program is distributed as user-supported
  124.                          software.  If you find the program useful or
  125.                          entertaining, you can become a registered user by
  126.                          sending a contribution of $15 to the author:
  127.  
  128.                                  Mike Kirsch
  129.                                  292 Circular Avenue
  130.                                  San Francisco, CA  94131
  131.  
  132.  
  133.  
  134.  
  135.           Mouse Composition System                                    Page 1
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                                                                 INTRODUCTION
  143.                                                                      (cont.)
  144.           __________________________________________________________________
  145.  
  146.  
  147.           Reaching Me    You may send questions, commands or suggestions for
  148.                          improvement to me on the following timesharing
  149.                          services:
  150.  
  151.                                  CompuServe  -  70110,334
  152.                                  Source      -     BDF331
  153.                                  GEnie       -   M.KIRSCH
  154.  
  155.                          My time to respond to correspondence is limited. 
  156.                          Queries from registered users will receive
  157.                          priority.
  158.  
  159.  
  160.           Future         The future of this software depends on how it is
  161.           Versions       received.  If a lot of interest is expressed, I'll
  162.                          try to incorporate suggestions for improving and
  163.                          expanding the system.  Registered users will be
  164.                          notified of future versions by U.S. mail.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           Mouse Composition System                                    Page 2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                                              GETTING STARTED
  203.  
  204.           __________________________________________________________________
  205.  
  206.  
  207.           Mouse          Before you can run this program, you need to load
  208.           Driver         your mouse's driver software.  If you own a Mouse
  209.                          Systems PC mouse, you load the driver by typing the
  210.                          following command at the DOS prompt:
  211.  
  212.                            MSMOUSE /<port>[Return]
  213.  
  214.                          The variable <port> must be replaced by 1 or 2 to
  215.                          specify which communications port your mouse is
  216.                          using.  For example, the following command
  217.                          specifies that the mouse is using COM1:
  218.  
  219.                            MSMOUSE /1[Return]
  220.  
  221.                          If you're using another manufacturer's mouse, check
  222.                          the instructions that came with the mouse to
  223.                          determine how you should load the mouse's driver
  224.                          software.
  225.  
  226.  
  227.           Loading        Once you've loaded your mouse's driver software,
  228.           the            you start the program by typing:
  229.           Program
  230.                            COMPOSE[Return]
  231.  
  232.                          The program displays a copyright notice, plays a
  233.                          few bars of a song, then draws the input screen.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.           Mouse Composition System                                    Page 3
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                                             THE INPUT SCREEN
  263.  
  264.           __________________________________________________________________
  265.  
  266.  
  267.           Layout         The input screen contains three major areas:
  268.  
  269.                            o The program identification line, at the top,
  270.                              tells which version of the program you are
  271.                              using and displays the current time of day.
  272.  
  273.                            o The music area, between the first and second
  274.                              horizontal lines, allows you to enter the music
  275.                              you want to play, and displays the current
  276.                              octave, note length, tempo, number of measures
  277.                              you've saved and the contents of the input
  278.                              buffer.
  279.  
  280.                            o The functions area, between the second and
  281.                              third horizontal lines, allows you to select
  282.                              edit, play, file and other functions.
  283.  
  284.                          The music and functions areas are described in
  285.                          detail in the following pages.
  286.  
  287.  
  288.           Indicating     Anytime you want to make a choice, you use the
  289.           Choices        mouse to move the cursor so that it is on top of
  290.                          the item you want to choose.  After you've
  291.                          positioned the cursor, you press the LEFT mouse
  292.                          button to register your choice.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.           Mouse Composition System                                    Page 4
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.                                                             THE INPUT SCREEN
  323.                                                                   Music Area
  324.           __________________________________________________________________
  325.  
  326.  
  327.           Headings       The music area contains lines which have the
  328.                          following headings:
  329.  
  330.                            o Octave
  331.  
  332.                            o Length
  333.  
  334.                            o Notes
  335.  
  336.                            o Current
  337.  
  338.                            o Buffer contents
  339.  
  340.  
  341.           Octave         The Octave heading is followed by the numbers 0
  342.                          through 6.  These are the octaves in which you may
  343.                          play notes.  The left and right arrows following
  344.                          the octave numbers cause the currently-selected
  345.                          octave to be raised or lowered once for each time
  346.                          you select them.
  347.  
  348.                          When you've selected an octave, it's number is
  349.                          displayed on the "Current" line, next to "Octave=". 
  350.                          The octave command is added to the buffer, and
  351.                          displayed below the "Buffer contents:" line.
  352.  
  353.  
  354.           Length         The Length heading is followed by the numbers 1/1
  355.                          through 1/64.  These represent a whole note (1/1)
  356.                          through a 64th note.  Below the note lengths,
  357.                          you'll see the words "Normal", "Legato" and
  358.                          "Staccato", which select the duration that each
  359.                          note is plays.  "Normal" causes each note to play
  360.                          7/8 of the selected the length; "Legato" causes
  361.                          each note to play the full amount of the selected
  362.                          length; "Staccato" causes each note to play 3/4 of
  363.                          the selected length.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.           Mouse Composition System                                    Page 5
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.                                                             THE INPUT SCREEN
  383.                                                           (cont.) Music Area
  384.           __________________________________________________________________
  385.  
  386.  
  387.           Notes          The notes heading is followed by the notes C
  388.                          through B.  You select notes you want to play from
  389.                          this line.  When you make a selection, the note
  390.                          that plays is in the currently-selected octave.
  391.  
  392.                          To play a dotted note, you select the note and then
  393.                          select "Dot".
  394.  
  395.                          To enter a rest, you select a length and then
  396.                          select "Pause".
  397.  
  398.                          You can play a note without adding it to the buffer
  399.                          by pointing to it and pressing the RIGHT mouse key. 
  400.                          This is the ONLY time that the right mouse key is
  401.                          recognized.
  402.  
  403.  
  404.           Current        The Current heading displays:
  405.  
  406.                            o The currently-selected octave
  407.  
  408.                            o The currently-selected length
  409.  
  410.                            o The currently-selected tempo, which specifies
  411.                              the number of quarter notes that are played in
  412.                              one minute
  413.  
  414.                            o The number of measures that have been saved
  415.                              from the buffer
  416.  
  417.  
  418.           Buffer         The music that you record is placed in a buffer.
  419.           Contents       The contents of the buffer is displayed on the two
  420.                          lines below the Buffer contents heading.
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.           Mouse Composition System                                    Page 6
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.                                                             THE INPUT SCREEN
  443.                                                               Functions Area
  444.           __________________________________________________________________
  445.  
  446.  
  447.           Function       The functions that you can choose fall into four
  448.           Types          categories:
  449.  
  450.                            o Edit Functions--which allow you to manipulate
  451.                              the buffer's contents and any music that you've
  452.                              saved from the buffer
  453.  
  454.                            o Play Functions--which allow you to play the
  455.                              buffer's contents, a measure that you've
  456.                              previously saved or a single measure that
  457.                              you've previously saved.  You can also change
  458.                              the tempo from the play functions.
  459.  
  460.                            o File Functions--which allow you to save a song
  461.                              in a file, load a song you've previously saved
  462.                              or create a text file that can appended to a
  463.                              BASIC program to play the song you've composed.
  464.  
  465.                            o Misc Functions--which allow you to print the
  466.                              song you've composed on your printer, redraw
  467.                              the input screen (in case something goes wrong
  468.                              and causes the screen to scroll), change the
  469.                              configuration file (your monitor's type, colors
  470.                              and your printer's port) and quit the program
  471.                              to return to DOS.
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.           Mouse Composition System                                    Page 7
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.                                                            USING THE PROGRAM
  503.  
  504.           __________________________________________________________________
  505.  
  506.  
  507.           Concepts       The concepts used by this program are simple:
  508.  
  509.                            o Use the mouse to point to selections.
  510.  
  511.                            o Press the mouse's left button to record your
  512.                              selections in the buffer.
  513.  
  514.                            o Compose and edit each measure of a song in the
  515.                              buffer, then save the measure as a part of the
  516.                              song and go onto the next.
  517.  
  518.  
  519.           Making         Whenever you select something from the music area
  520.           Music          (an octave, length, duration or note), the
  521.                          corresponding BASIC command(s) required to carry
  522.                          out your selection are added to the buffer.  If
  523.                          your selection is a note, it is played after it has
  524.                          been added to the buffer.
  525.  
  526.                          The buffer's contents are interpreted according to
  527.                          the instructions for BASIC's PLAY command. 
  528.                          Briefly, they are:
  529.  
  530.                            o Note lengths are shown as an "l" followed by a
  531.                              number representing the note length; a whole
  532.                              note is "l1", a quarter note is "l4", etc.
  533.  
  534.                            o Rest lengths are shown as a "p" followed by a
  535.                              number representing the rest length; a half
  536.                              rest is "p2", a thirty-second rest is "p32",
  537.                              etc.
  538.  
  539.                            o Durations are shown as an "m" followed by a
  540.                              duration letter; "mn" is normal, "ml" is legato
  541.                              and "ms" is staccato.
  542.  
  543.                            o Octaves are shown as an "o" followed by an
  544.                              octave number; octave 3 is "o3", octave 5 is
  545.                              "o5", etc.
  546.  
  547.                            o Notes are shown by their letters; C is "c", F
  548.                              sharp is "F#", etc.
  549.  
  550.                            o Tempo is shown as a "t" followed by a number
  551.                              between 32 and 255; "t200" means that 200
  552.                              quarter notes will be played in a one-minute
  553.                              period.
  554.  
  555.           Mouse Composition System                                    Page 8
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.                                                            USING THE PROGRAM
  563.                                                                      (cont.)
  564.           __________________________________________________________________
  565.  
  566.  
  567.           Correcting     If you make a mistake (select a wrong note, length,
  568.           Errors         etc.), you can correct it by pointing to
  569.                          "Backspace" in the edit functions box.  "Backspace"
  570.                          deletes one character from the buffer.  Note:  If
  571.                          you've selected something that added more than one
  572.                          character to the buffer (a length of 64, for
  573.                          example--"l64"), be sure to backspace over the
  574.                          entire selection.
  575.  
  576.                          If you want to delete the entire contents of the
  577.                          buffer, select "Clear the Buffer" from the edit
  578.                          functions box.  Everything in the buffer will be
  579.                          deleted and you can begin your composition again.
  580.  
  581.  
  582.           Playing        You can play the entire contents of the buffer
  583.           the            by selecting "Play the Buffer" from the play
  584.           Buffer         functions box.  Everything in the buffer will be
  585.                          played.
  586.  
  587.  
  588.           Saving         Once you've composed a measure of a song in the
  589.           the            buffer, you can save it as the song's next measure
  590.           Buffer         by selecting "Save the Buffer" from the edit
  591.                          functions box.  When you save the buffer, you'll
  592.                          notice that the "Measures=" value is increased by
  593.                          one.  Depending on the amount of memory that your
  594.                          computer has, you can save up to 4096 measures.
  595.  
  596.  
  597.           Playing        Once you've composed and saved some measures, you
  598.           the Song       can hear what they sound like together by selecting
  599.                          "Play the Song" from the play functions box.  If
  600.                          something is stored in the buffer, it is played as
  601.                          the last measure of the song.
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.           Mouse Composition System                                    Page 9
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.                                                            USING THE PROGRAM
  623.                                                                      (cont.)
  624.           __________________________________________________________________
  625.  
  626.  
  627.           Editing        You can edit a song using the following functions:
  628.           the Song
  629.                            o Replace a Measure--replaces a measure that
  630.                              you've saved with the current contents of the
  631.                              buffer.  If the buffer is empty, the replace
  632.                              selection is ignored.
  633.  
  634.                            o Copy Measures--allows you to specify a range of
  635.                              measures that you've saved, then appends them
  636.                              to the song.
  637.  
  638.                            o Delete Measures--allows you to specify a range
  639.                              of measures that you've saved, then deletes
  640.                              them from the song.  Any measures that follow
  641.                              the deleted measures are moved down to fill the
  642.                              gap created by the deletion.
  643.  
  644.  
  645.           Saving         When you've finished composing a song, or if you
  646.           the Song       need to stop work on a song, you can save your work
  647.                          by selecting "Save the Song" from the file
  648.                          functions box.  You are asked enter a file name
  649.                          when you select this option; the file automatically
  650.                          receives an extension of ".mmc".
  651.  
  652.                          You can also save your work as a BASIC program by
  653.                          selecting "Make a Basic File" from the file
  654.                          functions box.  You are asked to enter a file name
  655.                          when you select this option; the file automatically
  656.                          receives an extension of ".bas".  You must specify
  657.                          a starting line number and an increment value that
  658.                          will be used to create the BASIC program.
  659.  
  660.                          Note:  If you want to edit or continue work on a
  661.                          program, you MUST save it as a ".mmc" file (using
  662.                          the "Save the Song" function) so that it can be
  663.                          loaded at a later time.
  664.  
  665.  
  666.           Loading        You can load a previous composition for editing or
  667.           a Song         playback by selecting "Load a Song" from the play
  668.                          functions box.  Only files with a ".mmc" extension
  669.                          can be loaded.  The load function doesn't check a
  670.                          song at load time; if you load a file that you've
  671.                          given the ".mmc" extension to, who knows what will
  672.                          happen!
  673.  
  674.  
  675.           Mouse Composition System                                   Page 10
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.                                                            USING THE PROGRAM
  683.                                                                      (cont.)
  684.           __________________________________________________________________
  685.  
  686.  
  687.           Printing       You can make a printout of the current song by
  688.           the            selecting "Print the Song" from the misc functions
  689.           Song           box.  Measure numbers are added to each line to
  690.                          make it easy to locate segments of the song.
  691.  
  692.  
  693.           Changing       You can change your monitor type, screen colors
  694.           Options        and printer options by selecting "Change
  695.                          Configuration" from the misc functions box.
  696.  
  697.  
  698.           Summary        I've had fun writing this program; I hope you'll
  699.                          have fun using it.  If you create some particularly
  700.                          fine music, I hope you'll share it by placing the
  701.                          ".mmc" files on some bulletin boards.
  702.  
  703.                          If you want to become a registered user, you can
  704.                          use the registration from on the next page.
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.           Mouse Composition System                                   Page 11
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.                                   REGISTRATION FORM
  743.  
  744.  
  745.  
  746.           Please register me as a Mouse Composition System user.  I have
  747.           enclosed a:
  748.  
  749.                          [ ] Check
  750.                          [ ] Money Order
  751.  
  752.           for $15 to cover my registration.
  753.  
  754.  
  755.           Please PRINT all information
  756.  
  757.           Name:  _____________________________________________________
  758.  
  759.           Address:  __________________________________________________
  760.  
  761.           City:  ____________________________
  762.  
  763.           State:  ____  Zip:  __________
  764.  
  765.  
  766.           What type of computer are you using this software on?
  767.  
  768.           _____________________________________________________
  769.  
  770.           How much memory does your computer have?  __________K
  771.  
  772.           What type of mouse are you using?
  773.  
  774.           ________________________________
  775.  
  776.  
  777.  
  778.           Mail this form and your contribution to:
  779.  
  780.           Mike Kirsch
  781.           292 Circular Avenue
  782.           San Francisco, CA  94131
  783.  
  784.  
  785.  
  786.           NOTE:  Please, don't send CASH through the mail.
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.           Mouse Composition System                                   Page 12
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.